Rewrote 4 high-impact documentation files to improve user onboarding and reduce friction for new users.

Files Changed

• docs/overview.mdx - Main landing page
• docs/basic/core-concepts.md - Core concepts guide
• docs/basic/try-with-docker.md - Quick start guide
• docs/contributing.md - Contributor guide

Key Improvements

• Progressive disclosure: Start with simple concepts, layer in complexity
• Real examples: Replace abstract descriptions with concrete use cases
• Scannability: Add tables, emojis, clear headings for quick navigation
• Action-oriented: Include troubleshooting, next steps, and clear CTAs
• Conversational tone: Remove formal language barriers

Example

Before:

Casdoor is a UI-first Identity Access Management (IAM) / Single-Sign-On (SSO) 
platform with a web UI that supports OAuth 2.0, OIDC, SAML, CAS, LDAP, SCIM, 
WebAuthn, TOTP, MFA, RADIUS, Google Workspace, Active Directory, and Kerberos.

After:

## What is Casdoor?

Casdoor is a modern, UI-first Identity Access Management (IAM) and Single-Sign-On 
(SSO) platform that makes authentication and user management simple and secure. 
Whether you're building a small app or managing enterprise-scale authentication, 
Casdoor provides everything you need in one elegant package.

With support for OAuth 2.0, OIDC, SAML, LDAP, and many more protocols, Casdoor 
seamlessly integrates with your existing infrastructure while providing a beautiful 
web interface for managing users, applications, and authentication flows.

Scope

These 4 files represent primary entry points for new users. Remaining 252 documentation files can follow the same patterns.

• Fixes [feature] rewrite all docs pages to be more natural and engaging #974

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.